home *** CD-ROM | disk | FTP | other *** search
/ PC World 2008 February / PCWorld_2008-02_cd.bin / domacnost a kancelar / notepad++ / npp.4.7.3.Installer.exe / plugins / doc / NppExec.txt < prev    next >
Text File  |  2007-12-27  |  8KB  |  173 lines
  1.  ****************************************************************************
  2.  * NppExec plugin ver. 0.2 RC2 for Notepad++ 4.3 (and above)
  3.  * by DV, December 2006 - July 2007
  4.  * by DV & Nicolas Babled & Geert Vancompernolle, July 2007 - December 2007
  5.  ****************************************************************************
  6.  *
  7.  * Possibilities:
  8.  *   1) Run multiple commands from the "Execute..." dialog
  9.  *   2) Run stand-alone command from the Console Dlg
  10.  *   3) Separate console for each NppExec.dll (e.g. NppExec1.dll, NppExec2.dll)
  11.  *   4) Additional commands:
  12.  *        cls - clear Console screen
  13.  *        cd - shows current path
  14.  *        cd <path> - changes current directory (absolute or relative)
  15.  *        cd <drive:\path> - changes current drive and directory
  16.  *        dir - lists subdirs and files
  17.  *        dir <mask> - lists subdirs and files matched the mask
  18.  *        dir <path\mask> - lists subdirs and files matched the mask
  19.  *        echo <text> - prints a text in the Console 
  20.  *        set - shows all user's variables
  21.  *        set <var> - shows the value of user's variable <var>
  22.  *        set <var> = <value> - sets the value of user's variable <var>
  23.  *        unset <var> - removes user's variable <var>
  24.  *        con_loadfrom <file> - loads a file's content to the Console
  25.  *        con_load <file> - see "con_loadfrom"
  26.  *        con_saveto <file> - saves the Console's content to a file
  27.  *        con_save - see "con_saveto"
  28.  *        npp_exec <script> - execute commands from specified script
  29.  *        npp_exec <file> - execute commands from specified file         (*)
  30.  *        npp_open <file> - open a file in Notepad++
  31.  *        npp_open <mask> - open files matched the mask
  32.  *        npp_open <path\mask> - open files matched the mask
  33.  *        npp_run <command> - run external process/command
  34.  *        npp_save - save current file in Notepad++
  35.  *        npp_save <file> - save a file in Notepad++ (if it's opened)    (*)
  36.  *        npp_saveall - save all modified files
  37.  *        npp_switch <file> - switch to specified opened file            (*)
  38.  *        (*) these commands work with a partial file path/name also
  39.  *            i.e.  npp_save c:\dir\f.txt  is the same as  npp_save f.txt
  40.  *   5) Additional console commands (Console Dlg only):
  41.  *        help       - show available commands
  42.  *        ver        - show plugin's version
  43.  *        CTRL+C     - terminate current child process
  44.  *        CTRL+BREAK - terminate current child process
  45.  *   6) All Notepad++ environment variables are supported:
  46.  *        $(FULL_CURRENT_PATH) : E:\my Web\main\welcome.html 
  47.  *        $(CURRENT_DIRECTORY) : E:\my Web\main
  48.  *        $(FILE_NAME)         : welcome.html 
  49.  *        $(NAME_PART)         : welcome 
  50.  *        $(EXT_PART)          : html
  51.  *        $(NPP_DIRECTORY)     : the full path of notepad++'s directory
  52.  *        $(CURRENT_WORD)      : word(s) you selected in Notepad++
  53.  *   7) Additional environment variables:
  54.  *        $(#0)                : C:\Program Files\Notepad++\notepad++.exe
  55.  *        $(#N), N=1,2,3...    : full path of the Nth opened document
  56.  *        $(LEFT_VIEW_FILE)    : current file path-name in primary (left) view
  57.  *        $(RIGHT_VIEW_FILE)   : current file path-name in second (right) view
  58.  *        $(ARGC)              : number of arguments passed to the NPP_EXEC command
  59.  *        $(ARGV)              : all arguments passed to the NPP_EXEC command after the script name
  60.  *        $(ARGV[0])           : script name - first parameter of the NPP_EXEC command
  61.  *        $(ARGV[N])           : Nth argument (N=1,2,3...)
  62.  *        $(RARGV)             : all arguments in reverse order (except the script name)
  63.  *        $(RARGV[N])          : Nth argument in reverse order (N=1,2,3...)
  64.  *        $(SYS.<var>)         : system's environment variable, e.g. $(SYS.PATH)
  65.  *
  66.  ****************************************************************************
  67.  
  68.  
  69.  *************
  70.  *  HISTORY  *
  71.  *************
  72.  
  73.  
  74.  v0.2 RC2 - December 2007
  75.  ------------------------
  76.  + speeding up the console output
  77.  + watching for changes in "npes_saved.txt"
  78.  + TAB-key in the console auto-completes current command
  79.  + several cosmetic improvements
  80.  
  81.  
  82.  v0.2 RC1 - December 2007
  83.  ------------------------
  84.  1. A lot of internal changes/improvements.
  85.  In particular, now all plugin's options are stored, read and written by the
  86.  Options Manager component.
  87.  The Warning Analyzer component, developed by Nicolas Babled, allows to filter
  88.  and recognize different compiler/interpretter error and warning messages - and
  89.  extract useful information from these messages (such as file name and line 
  90.  number).
  91.  The Simple Logger component stores detailed information about last executed
  92.  command (can be usefull for "debugging").
  93.  * The console redirecting engine has been improved.
  94.  * Now the plugin identifies itself by its dll-file name. Each copy of the 
  95.  plugin (each dll-file) stores its options in corresponding ini-file.
  96.  * Now plugin's environment variables (e.g. "$(FILE_NAME)") are available for
  97.  child console process. For example, start "cmd.exe" and type "echo $(#1)".
  98.  * Now system's environment variables are available in a form of "$(SYS.<var>)"
  99.  e.g. "$(SYS.WINDIR)", "$(SYS.TEMP)" etc.
  100.  * Now the NPP_EXEC command can pass arguments to the script. These arguments 
  101.  can be accessed in the script through the following macro-variables:
  102.  $(ARGC), $(ARGV), $(ARGV[n]).
  103.  Example:  npp_exec "script name" param_1 "param 2".
  104.  This example sets the following values for the script:
  105.  $(ARGC) = 3;  $(ARGV) = param_1 "param 2";  $(ARGV[0]) = script name;
  106.  $(ARGV[1]) = param_1;  $(ARGV[2]) = param 2.
  107.  * Each command now have detailed help information. Type "help" or "help help" 
  108.  in the NppExec's Console.
  109.  * Now the console commands history is restored when you restart Notepad++.
  110.  
  111.  2. New menu items:
  112.  Direct Execute Previous - directly executes previous script.
  113.  No internal messages - do not show such messages as "Process started >>>", etc.
  114.  Save all files on execute - saves all files before executing a script.
  115.  Also NppExec's toolbar icon has been added.
  116.  
  117.  3. New dialog:  Console Output Filter -> Highlight.
  118.  This dialog allows you to specify a string mask for compiler/interpretter error 
  119.  and warning messages with such keywords as %FILE%, %ABSFILE% and %LINE%.
  120.  These messages can be highlighted with different colours and allow you to go
  121.  to certain line in certain file when double-clicked in the Console window.
  122.  
  123.  4. New messages:
  124.  NPP_SAVEALL - saves all modified files.
  125.  CON_LOADFROM - loads a file's content to the Console.
  126.  CON_SAVETO - saves the Console's content to a file.
  127.  ECHO - prints a text in the Console (supports internal env. variables)
  128.  SET - sets the value of user's variable
  129.  UNSET - removes user's variable
  130.  
  131.  
  132.  v0.2 beta4 - July 2007
  133.  ----------------------
  134.  - fixed: buffer size was not checked before calling OemToChar() 
  135.  - fixed/added: '\b' and '\r' handling
  136.  + a lot of changes in plugin's internals (basic cpp-classes and NppExecEngine)
  137.  + new command: cd, cd <path>, cd <drive:\path>
  138.  + new command: dir, dir <mask>, dir <path\mask>
  139.  + new feature: npp_open <mask>, npp_open <path\mask>
  140.  + new environment variables: $(LEFT_VIEW_FILE) and $(RIGHT_VIEW_FILE)
  141.  * thanks to all who wait for this version
  142.  
  143.  
  144.  v0.2 beta3 - April 2007
  145.  -----------------------
  146.  - fixed: Delete button (Script name dialog) was not enabled sometimes
  147.  + Menu: Show Console Dialog
  148.  + Console Output Filter: Exclude all empty lines
  149.  + Comment delimiter can be user-defined, // in :// is no more comment
  150.  
  151.  
  152.  v0.2 beta2 - March 2007
  153.  -----------------------
  154.  + Menu: Console Commands History.
  155.      When enabled, previous commands can be scrolled by pressing 
  156.      arrow keys Up and Down.
  157.  + Menu: Console Output Filter.
  158.      When enabled, output messages from running console process
  159.      can be filtered (i.e. particular lines can be excluded)
  160.  - ConsoleDlg: Ctrl+A is unlocked
  161.  - ConsoleDlg: Quotes "" are no more added automatically for paths
  162.      with spaces (because of a bug with executables w/o extension
  163.      such as "cmd /c calc.exe")
  164.  - Several internal fixes
  165.  - Several additional internal fixes :-)
  166.  * Thanks to Jim Granville for his suggestions
  167.       
  168.  
  169.  v0.1 - March 2007
  170.  -----------------
  171.  * initial version
  172.  
  173.